home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / game / role / ldmud-3.2-bin.lha / mud / doc / efun / debug_message < prev    next >
Text File  |  2001-04-06  |  1KB  |  38 lines
  1. SYNOPSIS
  2.         #include <debug_message.h>
  3.  
  4.         void debug_message(string text)
  5.         void debug_message(string text, int flags)
  6.  
  7. DESCRIPTION
  8.         Prints the given text to stdout, stderr, the <host>.debug.log file,
  9.         or any combination of these.
  10.         
  11.         The parameter <flags> is a combination of bitflags determining the
  12.         target and the mode of writing.
  13.  
  14.         The target flags are: DMSG_STDOUT, DMSG_STDERR and DMSG_LOGFILE.
  15.         If the flag DMSG_STAMP is given, the message is prepended with the
  16.         current date and time in the format 'YYYY.MM.DD HH:MM:SS '.
  17.  
  18.         If <flags> is given as 0, left out, or contains no target
  19.         definition, debug_message() will print to stdout and to the logfile.
  20.  
  21. EXAMPLE
  22.         debug_message("This goes to stdout and the logfile.\n");
  23.         debug_message("This goes to stderr.\n", DMSG_STDERR);
  24.         debug_message("This goes to stdout and stderr.\n"
  25.                      , DMSG_STDOUT | DMSG_STDERR);
  26.  
  27.         debug_message("This goes to stdout and the logfile, with timestamp.\n"
  28.                      , DMSG_STAMP);
  29.         debug_message("This goes to stdout and has the timestamp in front.\n"
  30.                      , DMSG_STDOUT | DMSG_STAMP);
  31.  
  32. HISTORY
  33.         Introduced in 3.2.1@34
  34.         LDMud 3.2.9 introduced the <flags> parameter.
  35.  
  36. SEE ALSO
  37.         last_instructions(E)
  38.